home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / pm-utils / README.debugging < prev    next >
Text File  |  2008-10-15  |  2KB  |  41 lines
  1. End-user customization and debugging:
  2.  
  3. * If a particular hook is causing problems on your system, you can disable it
  4.   using the HOOK_BLACKLIST environment variable by creating a file in 
  5.   /etc/pm/config.d and adding the line:
  6.   HOOK_BLACKLIST="hookname 99another-hook"
  7.  
  8. * If a parameter (or lack thereof) passed to pm-suspend and friends is causing
  9.   problems, or you need to debug the suspend/resume process to work out what 
  10.   quirks are causing problems, you can use the ADD_PARAMETERS and 
  11.   DROP_PARAMETERS environment variables.  To do this, create a file in 
  12.   /etc/pm/config.d, and add the following lines to it:
  13.   ADD_PARAMETERS="--parameter-to-add --another-parameter"
  14.   DROP_PARAMETERS="--parameter-to-drop --another-parameter-to-drop"
  15.  
  16.   If you want to drop all parameters (for testing purposes, or to work around 
  17.   bugs in HAL), you can use DROP_PARAMETERS="all"
  18.  
  19. * If you suspect that a kernel module is preventing you from being
  20.   able to suspend and resume, you can use the SUSPEND_MODULES
  21.   environment variable to have that module removed when the system
  22.   suspends and reloaded when the system wakes up.
  23.  
  24. * To find out what parameters can be passed to pm-suspend and friends, run them
  25.   with '--help' as the first parameter as root.  This will print out the 
  26.   options that it supports and which hooks or modules handle those options.
  27.  
  28. Significant conceptual changes from pm-utils 0.99.x and earlier:
  29.  
  30. * Do not rely on the internals of hooks when configuring or customizing
  31.   pm-utils.  Conceptually, hooks are black boxes from the point of view
  32.   of the pm-utils core code, and there is no guarantee that the implementation
  33.   of a given hook will not change from pm-utils revision to pm-utils revision.
  34.  
  35. * The preferred method of modifying the behaviour of a hook is to modify the
  36.   ADD_PARAMETERS and DROP_PARAMETERS to change the global parameters available
  37.   to each hook.
  38.  
  39. * All scripts created and maintained by the pm-utils are POSIX/SuS compliant.
  40.   Any modification or new script should be POSIX compliant and work as intended
  41.   using dash and posh before you submit a patch upstream.